3.1 Selecting the server

SIU reference: SIU-301.

To access the MyID server:

  1. Open your web browser.

    For a list of supported browsers, see section 2.1.1, Supported browsers.

  2. In the address bar, type the server address.

    For example:

    https://myserver.domain.com/MyID/OperatorClient/

    Important: The REST-based services that are used for the MyID Operator Client require SSL/TLS; if you do not connect through HTTPS, you cannot use the MyID Operator Client. For more information, see the REST-based web services section in the System Interrogation Utility guide.

  3. Press Enter.

3.1.1 Specifying the server for the MyID Client Service

You specify the address of the MyID web services server for the MyID Client Service when you install the service on the client PC.

See the Installing the MyID Client Service section in the Installation and Configuration Guide for instructions on installing the MyID Client Service.

If you need to change the web services server address after you have installed it, you must edit the MyIDClientService.dll.config file in the MyID Client Service program folder.

Open the file with a text editor, and edit the following line:

<add key="Server" value="https://myserver.domain.com"/>

Note: You must include only the server name in the address; do not include the full MyID web service URL.

Synchronizing the server URL with the Self-Service App

Instead of providing the details of the MyID server in the MyID Client Service configuration file, you can point the MyID Client Service at the configured server for your installation of the MyID Self-Service App. This means that if you need to change the server URL, you need only change it in the Self-Service App configuration file, and the MyID Client Service will be automatically updated to use the same MyID server.

To synchronize the MyID Client Service with the Self-Service App:

  1. In the MyIDClientService.dll.config file, remove or comment out the following lines:

    <add key="Server" value="https://myserver.domain.com"/>
    <add key="DataSource" value="MyIDDataSource/dataSource.asmx"/>

  2. Add the following line:

    <add key="SsaPath" value="C:\Program Files\Intercede\MyIDApp\Self Service Application\MyIDApp.exe"/>

    Replace the value with the actual location of the Self-Service App program file on the client PC.

Access control

You can also update the list of access control URLs (that is, the websites that are allowed to access the MyID Client Service) in the same file. You can specify more than one URL; use commas to separate the URLs.

Edit the following line:

<add key="AccessControlAllowOrigin" value="https://myserver.domain.com,https://myserver2.domain.com"/>

Note: You must include only the server name in the access control list; do not include the full MyID Operator Client URL.

For evaluation systems, you may want to disable the list of access control URLs; to do this, include the following line in the configuration file:

<add key="DisableAccessControl" value="true"/>

This is not recommended for production systems, as it affects the security of the MyID Client Service as it allows any client to communicate with it.

3.1.2 Troubleshooting server connection issues

If you have issues when connecting to the server, you are recommended to use the System Interrogation Utility to check your system configuration. SIU test ID 301 specifically checks the connection to the operator client URL.

If you experience problems, check the IIS logs on the web server, and ensure that there are no DNS issues that prevent the client PC from resolving the server URL. You may also want to restart IIS on the web server.